CTERMID

Section: C Library Functions (3)
Index Return to Main Contents

BSD mandoc
 

NAME

ctermid - generate terminal pathname  

SYNOPSIS

Fd #include <stdio.h> Ft char * Fn ctermid char *buf  

DESCRIPTION

The Fn ctermid function generates a string, that, when used as a pathname, refers to the current controlling terminal of the calling process.

If buf is the NULL pointer, a pointer to a static area is returned. Otherwise, the pathname is copied into the memory referenced by buf The argument buf is assumed to point to an array at least L_ctermid (as defined in the include file Aq Pa stdio.h ) bytes long.

The current implementation simply returns `/dev/tty'  

RETURN VALUES

Upon successful completion, a non- NULL pointer is returned. Otherwise, a NULL pointer is returned and the global variable errno is set to indicate the error.  

ERRORS

The current implementation detects no error conditions.  

SEE ALSO

ttyname(3)  

STANDARDS

The ctermid function conforms to St -p1003.1-88 .  

BUGS

By default the Fn ctermid function writes all information to an internal static object. Subsequent calls to Fn ctermid will modify the same object.


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ERRORS
SEE ALSO
STANDARDS
BUGS

This document was created by man2html, using the manual pages.
Time: 16:28:58 GMT, April 18, 2022